home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / games / nethk311.zoo / README.ST < prev    next >
Text File  |  1993-02-28  |  5KB  |  113 lines
  1. Here is the "official" NetHack 3.1.1 binary for Atari computers.
  2. It was compiled with gcc 2.2.2 and the MiNT library,
  3. patchlevel 25. Source code for this program was posted
  4. to the comp.sources.games newsgroup on Usenet, and is
  5. available from the comp.sources.games archives, from
  6. ftp.uu.net, linc.cis.upenn.edu, and various other places.
  7.  
  8. Please see the file "hackdir/license" for copying
  9. conditions. NetHack is free, but it is *not* public
  10. domain.
  11.  
  12. The following things are required to run this version of
  13. NetHack on your ST, TT, or Falcon:
  14.  
  15. (1) At least 2 megabytes of RAM.
  16.  
  17. (2) Lots of disk space. "Lots" means a hard disk
  18.     or 1.44 megabyte floppy, unless you can find a
  19.     program packer to compress nethack.tos down small
  20.     enough to fit on 1 floppy.
  21.  
  22. The file "NetHack.cnf" has the configuration information
  23. in it. You can edit this file with any plain ASCII editor.
  24. Lines starting with '#' are comments. Customize this
  25. as you see fit. If you're using a floppy disk, make
  26. sure you change the HACKDIR, LEVELS, and SAVE variables.
  27. If you have a ramdisk (I highly recommend one, it speeds
  28. things up a lot) make sure RAMDISK is set appropriately,
  29. otherwise make sure it is commented out. Note that
  30. if you are using a floppy, LEVELS should point to the
  31. floppy disk and you should definitely have a ramdisk,
  32. to which RAMDISK should be pointed. NetHack will use
  33. the ramdisk for as many of its temporary files as possible,
  34. and when it runs out of room there it will start swapping
  35. to the LEVELS directory.
  36.  
  37. The file "nethack.mnu" will provide nice menus for the
  38. nethack.tos program, but only if you're running
  39. MultiTOS with MINIWIN 1.1 or better. If not, throw
  40. this file out. (Actually, it probably will work with
  41. older versions of MINIWIN, but only if you delete the
  42. lines starting with '#' and all blank lines. It won't
  43. work with TOSWIN, and in fact will cause trouble with
  44. TOSWIN :-( ).
  45.  
  46. The "hackdir" subdirectory contains all the data files
  47. that nethack needs to run. If you're running with a
  48. 1 floppy setup, you should put "nethack.tos",
  49. "nethack.cnf", and (if appropriate) "nethack.mnu"
  50. on one floppy, and everything in hackdir on the
  51. other. Run nethack.tos, and after it starts up
  52. put the second floppy in the drive.
  53.  
  54. The game should run in any resolution. When booting in
  55. a low resolution mode (i.e. 40 columns of text), you may
  56. get some warnings about the screen size. Ignore these and keep
  57. playing; the game should work OK.
  58.  
  59. If you have a color monitor, you'll get colors unless you've
  60. set the "nocolor" option (or have "BIOS" turned off in
  61. NetHack.cnf). The number of colors you'll see on screen
  62. depends of course on your resolution; in a 4 color mode
  63. you'll see only red, green, black, and white, so not many
  64. things will be colored on screen. (NetHack 3.0 used to
  65. change the screen colors to get more effects; this isn't
  66. a nice thing to do in a multitasking environment, so
  67. NetHack 3.1 doesn't do it.) In a 16, 256, or true color
  68. mode you'll get more colors.
  69.  
  70. There's a program called "hackfnt.prg" included on the
  71. disk. This hasn't been tested very thoroughly (e.g. I
  72. don't know if it works with Speedo GDOS) so use it with
  73. caution; but if it works correctly it will change your
  74. font to something that provides more graphics characters.
  75. The sample nethack.cnf has some lines commented out
  76. that start with "GRAPHICS="; uncommenting these lines
  77. will produce a "neater" display.
  78.  
  79. The final program here is "recover.ttp". It's a program that
  80. lets you recover from crashes. Naturally we hope that NetHack
  81. won't crash; but if it does, or if you have a power outage or
  82. something while playing, you *may* be able to recover your game.
  83. To use it, make sure that all the levels files ("level.*") are
  84. in one directory (if you were playing with a ramdisk, some of these
  85. will be on the ramdisk -- copy them to wherever you keep your
  86. permanent copies, i.e. wherever LEVELS points to in NetHack.cnf).
  87. Then go to the LEVELS directory, and run recover like:
  88.     recover level yourname.sav
  89. (replace "yourname" with your name).
  90.  
  91. A TeX format guidebook is provided as guidebk.tex; this is also
  92. quite readable as plain ASCII if you don't have TeX.
  93.  
  94. Happy hacking!
  95.  
  96. Eric Smith
  97. ersmith@netcom.com
  98.  
  99. Bug reports should be sent to:
  100. nethack-bugs@linc.cis.upenn.edu.
  101.  
  102. Make sure you specify what kind of computer you're
  103. using (*definitely* mention that it's an Atari,
  104. and tell us as much as possible about your TOS
  105. setup, AUTO folder programs, etc.), tell us the
  106. version of NetHack (3.1.1 for the one here),
  107. and describe your problem in as much detail
  108. as possible. We get a lot of bug reports, for a lot
  109. of different machines (NetHack runs on everything
  110. from 8088 micros to mainframes), so without this
  111. information we'll have a much harder time tracking
  112. down bugs.
  113.